home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / string / RCS / strtok.man,v < prev   
Text File  |  1990-06-27  |  2KB  |  85 lines
  1. head     1.1;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.1
  10. date     90.06.27.11.39.48;  author shirriff;  state Exp;
  11. branches ;
  12. next     ;
  13.  
  14.  
  15. desc
  16. @@
  17.  
  18.  
  19.  
  20. 1.1
  21. log
  22. @Initial revision
  23. @
  24. text
  25. @.\" Copyright (c) 1988 The Regents of the University of California.
  26. .\" All rights reserved.
  27. .\"
  28. .\" Redistribution and use in source and binary forms are permitted
  29. .\" provided that the above copyright notice and this paragraph are
  30. .\" duplicated in all such forms and that any documentation,
  31. .\" advertising materials, and other materials related to such
  32. .\" distribution and use acknowledge that the software was developed
  33. .\" by the University of California, Berkeley.  The name of the
  34. .\" University may not be used to endorse or promote products derived
  35. .\" from this software without specific prior written permission.
  36. .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  37. .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  38. .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  39. .\"
  40. .\"    @@(#)strtok.3    5.1 (Berkeley) 11/14/88
  41. .\"
  42. .TH STRTOK 3 "November 14, 1988"
  43. .UC 3
  44. .SH NAME
  45. strtok, strsep \- string token operations
  46. .SH SYNOPSIS
  47. .nf
  48. .B char *strtok(str, sep)
  49. .B char *str, *sep;
  50. .PP
  51. .B char *strsep(str, sep)
  52. .B char *str, *sep;
  53. .fi
  54. .PP
  55. .I Strtok
  56. is used to isolate sequential tokens in a null-terminated string,
  57. .IR str .
  58. These tokens are separated in the string by
  59. .B "one or more"
  60. of the characters in
  61. .IR sep .
  62. The first time that
  63. .I strtok
  64. is called,
  65. .I str
  66. should be specified; subsequent calls, wishing to obtain further tokens
  67. from the same string, should pass a null pointer instead.  The separator
  68. string,
  69. .IR sep ,
  70. must be supplied each time, and may change between calls.
  71. .I Strtok
  72. returns a pointer to the start of each subsequent token in the string,
  73. after replacing the token itself with a NUL character.  When no more
  74. tokens remain, a null pointer is returned.
  75. .PP
  76. .I Strsep
  77. behaves similarly to
  78. .I strtok
  79. with the exception that the tokens in the string are separated by single
  80. occurrences of separator characters.  This routine was added to allow
  81. handling blank fields.
  82. .SH BUGS
  83. There is no way to get tokens from multiple strings simultaneously.
  84. @
  85.